home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / sifter25.zip / SIFTER25.DOC < prev   
Text File  |  1992-09-20  |  8KB  |  193 lines
  1.  I put this handy little utility together after trying to add the comments 
  2. from the BBS files catalog to my own file catalog.After 5 minutes of trying 
  3. to edit the comments into the neat columns that my catalog requires,I felt 
  4. that there had to be a better way.Hence the birth of Sifter,for sifting the 
  5. BBS file data into a neater columned format that your disk catalog program 
  6. can use.
  7.  
  8. Operation is very simple.Just type:
  9.  
  10.                      SIFTER
  11.  
  12.  and follow the prompts.
  13.  
  14. Sifter is designed to turn listings like this:
  15.  
  16. COMCALL1.ZIP    22715  05-18-92  Monitor phone line in your abscence and calls
  17.   specified phone number. When your phone rings a specified number of times,   
  18.   or you can set it to execute a command, like starting up COMM software.      
  19. DSMANUAL.ZIP   120805  05-17-92  US Robotics Modem Manual for all Courier 1    
  20.   models, including the newest 16.8k HST's.  Sam as printed manual that        
  21.   comes with modems. Great for searching on-line for that hard to remember     
  22.   command.                                                                     
  23. BGTLX211.ZIP   246873  05-17-92  Great background downloader for Telix/Qmodem  
  24. QM452TD2.ZIP   363750  05-17-92  QModem 4.52 Test Drive communications pkg 2/2 
  25. QM452TD1.ZIP   333041  05-17-92  Qmodem 4.52 Test Drive Communications pkg 1/2 
  26.  
  27. Into listings like this:
  28.  
  29. COMCALL1.ZIP   22715 05-18-92 Monitor phone line in your abscence and calls
  30.                               specified phone number. When your phone rings
  31.                               a specified number of times, or you can set it
  32.                               to execute a command, like starting up COMM
  33.                               software. 
  34. DSMANUAL.ZIP  120805 05-17-92 US Robotics Modem Manual for all Courier 1
  35.                               models, including the newest 16.8k HST's. Sam
  36.                               as printed manual that comes with modems. Great
  37.                               for searching on-line for that hard to remember 
  38.                               command.
  39. BGTLX211.ZIP  246873 05-17-92 Great background downloader for Telix/Qmodem
  40. QM452TD2.ZIP  363750 05-17-92 QModem 4.52 Test Drive communications pkg 2/2
  41. QM452TD1.ZIP  333041 05-17-92 Qmodem 4.52 Test Drive Communications pkg 1/2
  42.  
  43. That's it.
  44.  
  45.  Sifter now contains a configuration screen with several optional features:
  46.  
  47.  JUNK FILTER MANUAL MODE - This feature allows the user to manually view any
  48.  junk lines (graphics boxes) detected by Sifter and the option of keeping or 
  49.  removing the line.This comes in handy if the BBS list has file descriptions
  50.  with graphics boxes in the comment field.Sifter would normally remove all
  51.  such boxes when running in AUTO mode.
  52.  
  53.  EMBEDDED SPACE FILTER - This feature allows Sifter to search for and remove
  54.  extra spaces between words in the comment field.
  55.  
  56.  SEARCH AND REPLACE OPTIONS - This feature allows the user to have Sifter
  57.  search the comment field for a specified string of text and replace it with
  58.  whatever string the user chooses.This feature can also be used as a method
  59.  of removing unwanted text by simply hitting "Enter" at the replacement text
  60.  prompt.
  61.  
  62.  SOURCE FILE TYPE - This feature allows the user to choose the type of source
  63.  file for conversion.This version supports RBBS (TBBS and PC-Board files 
  64.  convert using this setting as well), Wildcat (old and new style),and FEBBS 
  65.  (files created with Availist convert using this setting too) formats.
  66.  
  67.  SAVE CONFIGURATION - Allows the user the user to save the current toggle
  68.  settings.
  69.  
  70. Note:
  71. Due to the fact that BBS's don't seem to standardize the structure their file 
  72. listings,Sifter may not be 100% effective in removing all of the "junk" lines
  73. that many BBS's insist on inserting throughout their catalogs.In the worst 
  74. case senario,Sifter will greatly reduce the editing chore that would otherwise 
  75. be required.
  76.  
  77. Files Included:
  78.  
  79.                         SIFTER.COM - executable file ;
  80.                         SIFTER.DOC - this file ;
  81.                         ANSIFT.BAT - batch file for use if you have
  82.                                      ANSI.SYS loaded ;
  83.  
  84. Revisions :
  85.  
  86. Version 1.0 :
  87.  
  88.    -Initial release as Convert.
  89.  
  90. Version 1.1 :
  91.  
  92.    -Renamed utility to Sifter which is somewhat more unique and a bit more
  93.     descriptive of what it does.
  94.    -Added filter to remove the boxes sometimes used to catagorize the files
  95.     by their functions.
  96.    -Modified the way the utility handled long file descriptions.
  97.    -Added recognition and removal of the pipe symbol (|) from PC-Board
  98.     type listings.
  99.  
  100. Version 1.1a :
  101.  
  102.    -Fixed bug in title display.
  103.  
  104. Version 2.0 :
  105.  
  106.    -Added color menu screens for nicer appearance.
  107.    -Added real time line counter.
  108.    -Added elapsed time counter after sort.
  109.    -Added valid line and junk line counters.
  110.    -Added beep tone to indicate operation completion.
  111.    -Added source file verification.
  112.    -Improved the line splitting routine.
  113.    -Improved the file description handling routine.
  114.  
  115. Version 2.1 :
  116.  
  117.    -Added configuation menu with save feature.
  118.    -Added junk filter manual mode.
  119.    -Added embedded space detection and removal.
  120.    -Added comment field string search with remove/replace.
  121.    -Fixed bug in report screen routine that caused program lockup when
  122.     undefined key was pressed.
  123.  
  124. Version 2.2 :
  125.  
  126.    -Fixed bug that caused clipping of the comments field when performing 
  127.     multiple conversions.
  128.    -Tweaked output file format to comply with BBSee BBS file database utility.
  129.    -Added source and target filenames to report screen.
  130.    -Now returns to configuration prompt screen when performing multiple
  131.     conversions.
  132.    
  133. Version 2.3 :
  134.  
  135.    -Added routine to allow user to abort conversion process as well as to
  136.     exit the program more efficiently from the filename prompt screen.
  137.    -Added routine to allow easier access to the configuration menu from the
  138.     filename prompt screen.
  139.    -Fixed bug that resulted in strange output when removing spaces from
  140.     filenames that had no extension.
  141.    -Fixed major bug in pipe symbol (|) removal routine.
  142.  
  143. Version 2.4 :
  144.  
  145.    -Added support for Wildcat, and FEBBS style listings.
  146.    -Fixed bug that resulted in a blank line being inserted into the output
  147.     file while deleting a text string when the string was the entire line.
  148.    -Fixed bug that occured when the source file was not found in the 
  149.     directory.When the filename prompt screen returned the previous filenames 
  150.     would also return causing screen garbage.Previous filenames are now 
  151.     flushed.
  152.  
  153. Version 2.5 :
  154.  
  155.    -Fixed a couple MAJOR bugs in version 2.4, most notedly in the FEBBS
  156.     routine.
  157.    -Added support for the older style Wildcat listings for the sake of 
  158.     completeness.
  159.    -Added word wrap routine on the primary comment line.
  160.    -Added fill characters that are placed in the file size and date fields
  161.     if they are missing in the source file.
  162.    
  163.  Special Thanks to Jim Suzda at Rapid River BBS for his help in providing
  164. ideas for some of the enhancements to Sifter as well as allowing me to use
  165. his BBS as a support board for distribution and feedback.
  166.  
  167. RAPID RIVER BBS
  168. 6848 Highway 34
  169. Rudolph,WI
  170. Phone: (715) 435-3855
  171.  
  172. Any comments or ideas that you may have can be left as a message on this 
  173. board.The latest version of Sifter can be found here as well.
  174.  
  175. If you find this utility useful then I ask that you send a $10.00
  176. contribution to:
  177.  
  178.  Perry Provost
  179.  156 Chartwell Drive,
  180.  Apt. 106
  181.  Sault Ste Marie,Ontario
  182.  Canada. P6A 6A2
  183.  
  184. This is chickenfeed when you think of how long it would take you to edit
  185. your listings the old fashioned way.Your contribution will clear your
  186. conscience that you aren't taking advantage of another person's work
  187. without compensating them for their efforts.It will also encourage me to
  188. continue to enhance and refine this program.
  189.  
  190. All programs mentioned here are the trademarks of their respective authors.
  191.  
  192. Enjoy!!
  193.